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package j unglee . vdbms . wdk . visual ; 
import java.io.*; 
import j ava . awt . * ; 
import j ava . ut il . * ; 



* <b> WrapperModel Class </b> 
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* <p>This class is used to model wrappers. A wrapper is 

* identified as a set of operations, some of which are connected 

* by links. Supported functions are: 

* <ul> 

* <li> construction of wrappers by adding or deleting links and 
operations. <\li> 

^ <li> rendering wrappers on a .canvas using the WrapperView class. 
</li> 

* <li> response to user input using the • WrapperController class 

* <li> shifting all links and operations. </li> 

* <li> scaling operations around center of gravity. </li> 

* </ul> 

* <p>Copyright (c) 1997, Junglee Corp. 

* @title WrapperModel 

* @author Stephan Erickson 

* ©version 1.0' 



public class WrapperModel 
implements Serializable 

{ 

//////////////// Constructor 1 1 1 1 1 1 1 1 1 1 1 1 1 / 1 1 

Create a wrapper model, and make it the current wrapper. **/ 
public WrapperModel ( ) { 
} 

//////////////// Methods //////////////// 

Get vector of wrapper listeners 
public Vector getWrapperListeners ( ) 
{ 

return wrapperListeners; 

} 

Allow a Visual GUI to register interest in events. 
public void addWrapperListener (WrapperListener wl) 
{ 

wrapperListeners . addElement (wl) ; 

} 

Get id **/ 
public String getld{) 
{ 

return theld; 

} 
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/** Set the id **/ 

public void setid (String id) 

{ 

theld = id; 

5 . } 

/** Get root operation 
public Operation^ getRoot ( ) 
{ 

10 return root; 

} 

Set the root operation 
public void setRoot (Operation op) 
15 { 

root ~ op; 

} 

/** Get Initialization File 
20 public String getlnitFile () 

{ 

return thelnitFile; 

} 

25 Set Initialization File **/ 

public void setlnitFile (String initFiie) 
{ 

thelnitFile = initFiie; 

} 

30 

Add breakpoint to operation 
public void addBreakpoint (Operation op) 
{ 

op . isBreakpoint = true; 

35 } 

Remove breakpoint from operation **/ 
public void removeBreakpoint (Operation op) 
{ 

40 op . isBreakpoint = false; 

} 

Does operation have breakpoint? 
public boolean isBreakpoint (Operation op) 
45 { 

return op . isBreakpoint ; 

} 

Warn message **/ 

50 public static void warn (Operation from, String message) { 

System . out . println { "In operation " + from.getId() + 
message) ; 
} 

55 /** Warn message 

public static void warn (String message) { 
System. out . println (message) ; 
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Print message 
public static void print (String message) { 
System. out . println (message) ; 

} 

5 

+ MODEL OPERATIONS + 

* Add operation to wrapper model 

10 * @param operation the operation to add 

* Does nothing if operation is null 
*/ 

public void addOperation (Operation operation) 

15 { 

if (operation! =null) { 

operation . setid (getNextOperationId () ) ; 
operation. setWrapperModel (this) ; 
if (! hasOperation (operation) ) { 
20 theOperationVector.addElement (operation) ; 

} 



25 



} 



* Add operation to wrapper model, and group with 

* existing operation list 

* @param operation the operation to add 

* Does nothing if operation is null 
30 V 

public void addOperation (Operation operation, OperationList 
operationList ) 
{ 

35 // Add operation to operation list 

if (operation! =null) { 

operationList . addOperation (operation) ; 
operation. setId (getNextOperationId ( ) ) ; 
. operation. setWrapperi^odel (this) ; 

40 } 

// Add operation list to wrapper 
if (operationList ! =null) { 
if (operation ! =null) 

operationList .setId(-operation.getId() ) ; 
45 operationList . setWrapperModel (this) ; 

if (! theOperationListVector. contains (operationList) ) { 
. theOperationListVector. addElement (operationList) ; 

} 

} 

50 } 

* Determine if operation is in wrapper 

* @param operation the operation 

55 * Returns false if operation is null 

V 

public boolean hasOperation (Operation operation) 
{ 
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if {operation ! =null ) { 

Enumeration e - theOperationVector . elements () ; 
for ( ; e . hasMoreElements { ) ; ) { 

Operation v = (Operation) e . nextElement {) ; 
if ( V . get Id ( ) ==operation . getid { ) ) 
return true; 

} 

} 

return false; 



/ ★ ★ 

* Remove Operation 

* @param operation the operation to remove 

* Does nothing if operation is null 

public void removeOperation (Operation operation) 
{ 

if (operation!=null) { 
removeLinks (operation) ; 
// Remove bound operation 

OperationList operationList = getOperationList (operation) 

if (operationList ! =null) { 

operationList . removeOperation (operation) ; 
// If operation list is empty, remove list 
if ( operationList . getOperations (). size () ==0 ) { 
removeOperationList (operationList) ; 

} 

} else { 

// Remove free operation 

theOperationVector . removeElement (operation) ; 

■ } 
} 

} 

/ * **■ 

* retrieve operations associated with wrapper 

* ©return vector of operations 
V 

public final Vector getOperations ( ) 
{ 

return theOperationVector; 

} 

* set operations associated with wrapper 

* Qparam vector of operations 
V 

public final void setOperations (Vector operations) 
{ 

theOperationVector = operations; 

} 

* retrieve operation edge is pointing to 

* ©return Operation 
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public final Operation getOperation (Operation operation, String 
linkName ) 
5 { 

Vector links = new Vector (); 

Enumeration e = theLinkVector . elements () ; 

for { ; e . hasMoreElements ( ) ; ) { 

Link link = (Link) e . nextElement ( ) ; 
10 if (link. getStartOperation 0 ==operation) { 

if (link. get Label ( ) . equals (linkName) ) 
return link. getEndOperation ( ) ; 

} 

} 

15 return null; 



* retrieve operation associated with id 

20 * @return Operation or null if no operations can be. found 

V 

public final Operation getOperation ( int id) 
{ 

25 Enumeration e = theOperationVector . elements {) ; 

for {; e . hasMoreElements 0 / ) { 

Operation o --= (Operation) e . nextElement () ; 
if (o . getid ( ) ==id) return o; 

} 

30 Enumeration e2 = theOperationListVector . elements () ; 

for (; e2 . hasMoreElements (); ) { 

OperationList ol = (OperationList ) e2 . nextElement {) ; 
if (ol . getId ( ) ==id) return ol; 

} 

35 return null; 

} 

* Add Link 

40 -k @param link the link to add. 

* Does nothing if link is null. 

public void addLink(Link link) 

45 { 

if (link!=null) { 

theLinkVector . addElement (link) ; 

} 

} 

50 

I k^ 

* Remove Link 

* @param link the link to remove 

* Does nothing if link is null 
55 V 

public void removeLink (Link link) 
{ 

if (link!=null) { 



-48- 



theLinkVector . removeElement (link) ; 

} 

} 

/ ★ ★ 

* Remove all links connected to a given operation 

* @param operation from which links should be removed 

* Does nothing if operation is null 
*/ 

public void removeLinks (Operation operation) 
{ 

if (operation ! =null) { 
// Find links to delete 
Vector deleteVector = new Vector (); 
Enumeration e = theLinkVector , elements () ; 
for ( ; e . hasMoreElements { ) ; ) { 

Link link = (Link) e . nextElement ( ) ; 
if (link. getStartOperation ( ) ==operation || 
link. getEndOperation ( ) ==operation) { 
deleteVector . addElement (link) ; 

} 

} 

// Delete list of links 

Enumeration e2 = deleteVector . elements () ; 
for (; e2 . hasMoreElements 0 ; ) { 

Link link = (Link) e2 . nextElement () ; 
theLinkVector . removeElement (link) ; 

} 

} 

} 

I -k-k 

retrieve links associated with wrapper 

* @return vector of links 

public final Vector getLinks () 
{ 

return theLinkVector; 

} 

* set links associated with wrapper 

* @param vector of links 
V 

public final void setLinks (Vector links) 
{ 

theLinkVector = links; 

} 

I k^ 

* retrieve links starting from operation 

* ©return vector of links 

public final Vector getLinks (Operation operation) 

-49- 



Vector links = new Vector (); 
Enumeration e = theLinkVector . elements () ; 
for { / e .hasMoreElements ( ) ; ) { 
5 Link link = ( Link) e . nextElement ( ) ; 

if (link. getStartOperation ( ) ==operation || 
link . getEndOperation ( ) ==operation) { 
links . addElement (link) ; 

} 

10 } 

return links; 



/ * ★ 

15 * Update link ids after unserialization process 

* (iparam vector of links 

public final void updateLinklds ( ) 

20 { 

Enumeration e = theLinkVector . elements () ; 
for {; e .hasMoreElements 0; ) { 

Link link = (Link) e . nextElement () ; 

U 25 // Check if link is valid 

|T: String linkName = link . getLabel ( ) ; 

g; Operation startOperation 

l^v, getOperation ( link . getStartOperationId { ) ) ; 

boolean f oundValidLink = false; 
30 if (startOperation!=null) { 

String [] linkArray = startOperation . getLinkNames () ; 
'2^' for (int i=0; i<linkArray . length; i++) { 

String validName = linkArray [ i] ; 
if (validName . equals (linkName) ) { 
Jl 35 f oundValidLink = true; 

fl^ } 

h } 



40 // Remove link if it is not valid 

if (! f oundValidLink I i startOperat ion—null) { 
removeLink(link) ; 

} 

45 // Update operation links 

Enumeration e2 = theOperationVector . elements () ; 
for (; e2 . hasMoreElements 0 ; ) { 

Operation operation = (Operation) e2 . nextElement () ; 
// Update wrapper model 
50 operation . setWrapperModel (this ) ; 

if (link.getStartOperationldO === operation . getid () ) { 
link. setStartOperation (operation) ; 

} 

if (link.getEndOperationldO == operation . getId () ) { 
55 link. setEndOperation (operation) ; 

} 

} 

// Update operation list links 

Enumeration e3 = theOperationListVector . elements () ; 
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for { ; e3 . hasMoreElements ( ) ; ) { 

OperationList operationList = (OperationList ) e3 . nextElement ( ) ; 
// Update wrapper model 
operationList . setWrapperModel (this ) ; 
5 if {link. getStartOperationId ( ) == operationList . getld( ) ) { 

link. setStartOperation (operationList) ; 

} 

if (link. getEndOperationId ( ) == operationList . getid () ) { 
link. setEndOperation (operationList) ; 

10 } 

// Update operation list element links 
Vector operations = operationList . getOperations () ; 
Enumeration e4 = operations . elements () ; 
for ( ; e4 . hasMoreElements ( ) ; ) { 
15 Operation operation = (Operation) e4 , nextElement () ; 

// Update wrapper model 

operation . setWrapperModel (this ) ; 

if ( link . getStartOperationId ( ) == operation . getId () ) { 
link. setStartOperation (operation) ; 

20 } 

if ( link . getEndOperationId ( ) == operation . getId () ) { 
link. setEndOperation (operation) ; 

} 



} 



30 * Update link ids after unserialization process 

* @param vector of links 
V 

public final void updateRootOperation { ) 

35 { 

Operation root = getOperation ( 1 ) ; 
setRoot (root ) ; 
if (root!=null) 

root . setWrapperModel (this ) ; 

40 } 

/ ★ * 

* Remove operation list 

* @param operationList the operation list to remove 
45 * Does nothing if operation list is null 

^/ 

public void removeOperationList (OperationList operationList) 
{ 

50 if (operationList ! =nuli ) { 

removeLinks (operationList) ; 

theOperationListVector . removeElement (operationList ) ; 

} 

} 



* Return operation list containing operation 

* @param operation the operation 

* @return operation list containing operation or null 
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public OperationList getOperationList (Operation operation) 
{ 

Enumeration e = getOperationLists {). elements () ; 
for ( ; e . hasMoreElements ( ) ; ) { 

OperationList operationList = (OperationList ) e . nextEiement () / 
Enumeration e2 = operationList . getOperations (). elements () ; 
for (; e2 , hasMoreElements 0; ) { 

Operation v = (Operation) e2 . nextEiement () ; 
if ( v==operation) 

return operationList; 

} 

} 

return null; 



/ ★ ★ 

* retrieve operation lists associated with wrapper 

* @return vector of links 
*/ 

public final Vector getOperationLists ( ) 
{ 

return theOperationListVector ; 

} 

/ -k ^ 

* set operation lists associated with wrapper 

* @param vector of operation lists 

public final void setOperationLists (Vector operationLists ) 
{ 

theOperationListVector = operationLists; 

} 

/ * ★ 

* ■ retrieve next unused operation id 

* ©return operation id 
V 

public int getNextOperationId () 
{ 

int i; 

for (i-1; i<Integer.MAX_VALUE; i++) { 
boolean cont = false; 

Enumeration e = theOperationVector . elements () ; 
Enumeration e2 = theOperationListVector . elements () ; 
for (; e . hasMoreElements 0; ) { 

Operation operation = (Operation) e . nextEiement () ; 

if (i==operation. getid ( ) ) 
cont = true; 

} 

for (; e2 . hasMoreElements 0; ) { 

OperationList operationList = (OperationList ) e2 . nextEiement ( ) 
Enumeration e3 = operationList . getOperations (). elements () ; 
for (; e3 . hasMoreElements (); ) { 

Operation operation = (Operation) e3 . nextEiement {) ; 
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if (i==operation. getid { ) ) 
cont = true; 

} 

} 

if ( ! cont) break; 

} 

return i; 

} 

SELECTION OPERATIONS 

* Set current selected wrapper element 

* @param e new selected wrapper element 

public void setSelectedElement (WrapperElement e) 
{ 

e . theSelectedElement = e; 

} 

/ ★ 

* Return current selected wrapper element 

* ©return wrapper Element 
V 

public WrapperElement getSelectedElement ( ) 
{ 

return WrapperElement . theSelectedElement ; 

} 

* Is wrapper element selected? 

* @param e wrapper element 

* @return true/false 
V 

public boolean isSelectedElement (WrapperElement e) 
{ 

return ( e==WrapperElement . theSelectedElement ) ; 

} 

/ / ★★★★★★★★★★★★★★★★★★★■A' OT^x A ******************** 

// The wrapper model in current use 

private static WrapperModel theWrapper = null; 

// The wrapper listeners 

Vector wrapperListeners = new Vector (); 

// The root operation 
Operation root; 

// List of operations 

private Vector theOperationVector = new Vector () ; 
// List of operation lists 

private Vector theOperationListVector - new Vector { ) 
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// List of links 

private Vector theLinkVector = new Vector () ; 

// The id of the wrapper 

private String theld = "*thunk*"; 

// The initialization file 
private String thelnitFile = null; 

} 
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package junglee . vdbms . wdk. visual; 

import java.awt.*; 

import java.io.*; 

import com . sun . j a va . swing . * ; 

/ + ★ 

<b> Wrapper Element Class </b> 

-k 

* <p>A wrapper element is either an operation or an operation list, 
or a link 

* between two operations. Wrapper elements have a label, color, 
size, associated 

* wrapper model and information about whether they are selected or 
not. They also 

* can have an associated image,, and id. 

<p>Copyright (c) 1997, Junglee Corp. 

* @title GraphElement 

* @author Stephan Erickson 

* ©version 1.0 

public class WrapperElement 
implements Serializable 

{ 

* Constructor 

*/ 

public WrapperElement ( ) 

{ 

} 

* Set label 

* @param label set label of element 
^/ 

public void setLabel {String label) 
{ 

theLabel = label; 

FontMetrics fm = 

Toolkit .getDefaultToolkit () . getFontMetrics (theFont) ; 
theLabelWidth = fm. stringWidth (label) ; 
theLabelHeight = fm. getHeight ( ) ; 

} 

/ -k-k 

* Get label 

^ ©return get label of element 

public String getLabel() 
{ 

return theLabel; 
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* Set color 

* @param color new color of element 
*/ 

public void setColor (Color color) 
{ 

theColor = color; 

} 



* Get color 

* Greturn current color of element 
*/ 

public Color getColorO 
{ 

return theColor; 

} 



* Set selected color 

* @param color new selected color 
*/ 

public void setSelectedColor (Color color) 
{ 

theSelectedColor = color; 

} 



* Get selected color 

* @return current selected color 
*/ 

public Color getSelectedColor ( ) 
{ 

return theSelectedColor; 

} 

★ 

* Set size 

* @param size set size of element 

* Do nothing if new size is below minimum allowed size. 

V 

public void setSize(int size) 
{ 

//if ( size>theMinimumSize) 
theSize = (double) size; 

} 



* Get size 

* ©return get size of element 
V 
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public int getSize{) 
{ 

return (int) theSize; 

} 



/ ★ -A- 

* Set selected 

* @param selected whether or not element is selected 
V 

public void setSelected (boolean selected) 
{ 

if { select ed==t rue) 

theSelectedElement = this; 
else 

theSelectedElement = null; 

} 

* Is selected 

* ©return whether or not element is selected 
V 

public boolean isSelected { ) 
{ 

return { this==theSelectedElement ) ; 

} 

* Get font 

* @return get font of element 
^/ 

public Font getFont { ) 
{ 

return theFont; 

} 

/ ★ + 

^ Get label width 

^ ©return get label width of element 
V 

public int getLabelWidth ( ) 
{ 

return theLabelWidth; 

} 

/k-k 

* Get label height 

* ©return get label height of element 

public int getLabelHeight () 
( 

return theLabelHeight ; 

} 
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* Set id 

* @param id id of element 
V 

public void setld(int id) { 
theld = id; 

FontMetrics fm 
Toolkit .getDefaultToolkit ( ) . getFontMetrics (theFont ) ; 
theldWidth = fm. stringWidth ( id+" " ) ; 
theldHeight = fm. getHeight { ) ; 



* Get id 

* ©return id of element 
V 

public int getld() { 
return theld; 

} 

I k-k 

* Get id width 
V 

public int getIdWidth() 
{ 

return theldWidth; 

} 

/ -k-k 

* Get id height 
V 

public int getldHeight ( ) 
{ 

return theldHeight ; 

} 

I -k-k 

* Set image icon 
^/ 

public void setlmagelcon (Imagelcon icon, int x, int 
{ 

thelmagelcon = icon; 
theXIcon = x; 
theYIcon = y; 

} 

/+* 

* Get image icon 
*/ 

public Imagelcon getlmagelcon { ) 
{ 

return thelmagelcon; 

} 
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^ -k-k 

* Get 



X position of icon 



public int getXIcon{) 
{ 

return theXIcon; 

} 

* Get y position of icon 
•*^/ 

public int getYIcon{) 
{ 

return theYIcon; 

} 

/ -k-k 

* Always associate every wrapper element with 

* wrapper model it belongs to. 

* Set associated wrapper model. 
V 

public void setWrapperModel (WrapperModel model) 
theWrapperModel = model; 

} 

* Get associated wrapper model 
V 

public WrapperModel getWrapperModel ( ) { 
return theWrapperModel; 

} 

//k-k-k-k-k-kk-k-k-k-k-k-k-k-k-k-k-kkk PRIVATE DATA 

// The size of this element, 
public double theSize = 10; 
// .The minimum size of this element, 
protected double theMinimumSize = 5; 

//The label associated with this element. 

protected String theLabel = ""; 

// The width of the label 

protected int theLabelWidth = 0; 

// The height of the label 

protected int theLabelHeight = 0; 

// The id of this element, 
protected int theld = 0; 
// The width of the id 
protected int theldWidth = 0; 
// The height of the id 
protected int theldHeight = 0; 
// Current id (static counter) 
protected static int theCurrentId = 0; 
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// Image Icon to display 

protected Imagelcon thelmagelcon = null; 
// X position of image icon 
5 protected int theXIcon = 0; 

// Y position of image icon 
protected int theYIcon = 0; 

// The font associated with this element. 
10 protected Font theFont = new Font ( "Arial Font . PLAIN, 14 ) ; 

// Color of this element 
protected Color theColor = Color. black; 
// The selected color of this element 
15 protected Color theSelectedColor = Color. red; 

// Selected element 

protected static WrapperElement theSelectedElement = null' 

20 / / The wrapper model 

protected WrapperModel theWrapperModel = null; 
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package junglee . vdbms . wdk. visual; 

import j unglee . vdbms , wdk . interpreter . * ; 

import junglee . vdbms . wdk . interpreter . Environment ; 

import java . lang. reflect . 

import j ava . awt . * ; 

import java.io.*; 

import java.net.*; 

import java.util.*; 

import com. sun . j ava . swing .* ; 

import junglee . vdbms . wdk . util ; 

An Operation is the basic unit of processing for Visual WDK 

* wrappers. Each Operation has an <tt>call</tt> method which does 

* the real work, and can call other Operations as 

* needed. Operations use the <tt>setXXX</tt> and <tt>getXXX</tt> 

* naming convention for properties 'that are set at -design time . 

* <p> As an Operation developer, you should <b>never do 
op. call (state) </b>. 

* Instead, you must always use the static method call (from, op, 
state) . 

* The static method takes care of debugging output and visual trace 

* display; it catches exceptions. Every call should return 

* an Environment, <b>never return null</b> from a call method. 

Stephan Erickson: Added a number of functions & merged the 

* Operation with the GraphModel vertex class. */ 

public abstract class Operation 
extends WrapperElement 

{ 

/** Flow of control works by invoking an operation, that is, calling 
the call method of the operation, passing in any necessary 

* parameters. This. can be started when the user hits the "Run" - 

* button (or maybe clicks on the root Operation) . The call method 

* runs, and in most cases will call the call method of one of the 

* Operations it is wired up to, and perhaps call repeatedly, in a 

* loop. By default, this call should have the semantics of a normal 

* method call: it waits for the ' call :.to . complete, :and then returns 

* control to the parent call .method. We could have .the option of 

* running multiple invocations in parallel, but mostly! think that 

* would add to confusion, so let's leave it out (but not forget 

* about it) for the first version. So we have a model where we 

* start at the top, and call methods depth-first as we traverse 

* the web site, and simultaneously work through the wrapper. **/ 



* Constructor 



public Operation 0 
{ 

theCurrentId++; 
theld = theCurrentId; 
theSize = 15 ; 

name = shortName ( this . getClass ( ) . getName ( ) ) ; 
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+ + + c^lxj methods 



* Every operation must support an implementation of this method 

* @param state the start runtime' state 

* (?return state the end runtime state 
V 

protected abstract Environment call (Environment state) throws 
Throwable; 

/-k-k 

* This static method is what you should call, (within the body of 

* a non-static Operation . call method) to call another operation. 

* That is, do <tt>call ( this , getOpO, state) </tt>, not 

* <tt>getOp() .call(state)</tt>. The difference is that this static 

* method will gracefully handle a null operation, and it also 

* keeps track of trace information and updates the visual display 

* (if there is one) . 

public static Environment call (Operation from. Operation op, 

Environment state) throws Throwable { 
if (op == null II f rom. callsDisabled) return stated- 
signal ( "call " , null, state, from, op) ; 
Environment result = state; 
try { 

result = op . call ( state) ; // <== Real work here 
} catch (Exception e) { 

// Deal with recovering from exception here. ??? 
throw e; 

} 

signal ( "return" , null, result, op, f rom) ; 
return result; 



/^^^^^^^^^^^^^^^^^^ LINKING OPERATIONS TOGETHER 

k^-k-k-k-kk-k^-kk-k-kk-k-k-k-k-k-k^-k-k j 

/ -k-k 

* Every operation must provide the allowable link names via this 
function 

* @return list .of allowable operation' to operation link names 

public abstract String [] getLinkNames ( ) ; 
/ -k -k 

* This function is provided to make access to the link names 
easier 

* ©return vector of operation link names 
V 

public Vector getLinkNamesVector ( ) { 
String [] linkNames = getLinkNames () ; 
Vector rval = new Vector () ; 
for (int i=0; i<linkNames . length; i++) { 
rval . addElement (linkNames [i] ) ; 

} 
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return rval; 

} 

/ * * 

* Use this method to access the destination Operation of a link. 
Links are 

* no longer stored in the operations themselves, but in the 
wrapper model. 

* This allows us to avoid writing logic to keep two wrapper 

* representations in sync. 

public Operation getOperation ( String linkName) 
{ 

Operation op = theWrapperModel . getOperation (this, linkName); 
return op; 

} 

+ SIGNAL EVENTS + 

* Tell any listeners that this event occurred. Listeners register 

* via WrapperModel . getWrapper ( ) . addWrapperListener (cl ) . 

public static void signal {String eventType, Object data. 

Environment state. Operation from. 
Operation to) { 

if (from!=null) { 

WrapperModel wrapper = f rom . getWrapperModel ( ) ; 
Vector listeners = wrapper . getWrapperListeners () ; 
for (int i = 0; i < listeners . size {) ; i++) { 
( (WrapperListener ) listeners . elementAt (i) ) 
. eventOccurred (eventType, data, state, from, to); 

} 

} 

} 

+ ★ COORDINATE OPERATIONS 

* Move operation to absolute coordinates x,y 

* @param x destination x coordinate 

* @param y destination y coordinate 

public void moveTo(int x,int y) 
{ 

xO = x; 
yO = y; 

} 

* Move operation relative to coordinates xO,yO 

* @param deltaX relative x coordinate 

* @param deltaY relative y coordinate 

public void moveBy(int deltaX,int deltaY) { 
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xO+=deltaX; 
yO+=deltaY; 

} 

5 

* Scale size of operation using x as multiplier 

* @param x scale multiplier 
V 

10 public void scale (double x) { 

if (theSize*x>theMinimumSize) { 
xO x; 
yO x; 

} 

15 } 

/ * ★ 

* Return distance from x, y to operation 

* @param x the x coordinate 
20 * @pa ram v the v coordinate 

public int distanceFrom ( int x, int y) { 

return (int) Math. sqrt ( (x-xO) * (x-xO) + (y-yO) * (y-yO) ) ; 

25 } 

/ -k -k -^^ -k -k -k -k -k -k -ir -ir -k -k -k -k -ir -k -k -k -k -k pQLLOWING LINKS / 



'"^^^ 30 * Follow link from url . Specify post query if POST 

]\ * is required, otherwise specify null for the 

* postQuery parameter 

^c=J' * @param url in string form 

\1M * {§param post query in string form (EG: a=34&b=this is a test&c=0) 

iH: 35 V 

public String followLink (String url, String postQuery) 

•u^ { 

URL inUrl = null/ 
40 String text - ""; 

try { 

inUrl = new URL(url); 
text = netClient .getText (inUrl) ; 
} catch (Exception e) { 
45 e.printStackTrace ( ) ; 

// SFE change 

} 

return text; 

} 

50 

public URL convertUrl (String url) 
{ 

URL newUrl = null; 
try { . 
55 newUrl = new URL (url); 

} catch (Exception ex) { 

ex.printStackTrace 0 ; // SFE change 

} 

return newUrl; 
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y * -jt Tir * ^ + * PROPERTY SETTER/GETTERS 



* The name of an Operation is a short label for use by the human, 

* and for debugging output. It defaults to the unqualified class 
name, 

* but can be set to anything you want. 

public String getName ( ) { return name; } 

public void setName ( String name) { this. name = name; } 

* The comment of an Operation can be a longish comment block 

* describing what this operation is used for in this wrapper. 

* There will also be Help documentation that says what each 
Operation 

* class is for, and how to use it. But . that ..comes ' later . 

public String getComment ( ) { return comment; } 

public void setComment ( String desc) { this. comment = desc; } 

* The coordinates of the operation 

public void setX{int x) { xO = (double) x; } 
public int getX { ) { return {int)xO; } 
public void setY(int y) { yO = (double) y; } 
public int getY ( ) { return (int)yO; } 

/ ★ 

* Given a qualified class name as argument, return the unqualified 
part . 

* That is, the part after the last Also remove "Operation" 
if it is 

* at the end. 

public static String shortName (String className) { 
if { className . endsWith ( "Operation" ) ) 

className = className . substring ( 0 , className . length () -9) ; 
int dot - className . lastlndexOf (*.') ; 
if (dot == -1) return className; 
else return className . substring (dot+1 ) ; 



* Return the operation's name, 
public String toString() { return getName () ; } 



j-k-k-k^-k-k-^-k-k-k-kk-k-k-k-k-k-k A / 
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Name of operation 
String name — ""; 

Comment associated with operation **/ 
String comment = ""; 

/** Should we print information for debugging WrapperBuilder ? This 

s 

* for a developer debugging WrapperBuilder; not a user debugging 

* a wrapper. 

static boolean debugging = true; 

// The net client static object used to support followLink 
static Web netClient = new Web ( ) ; 

Is this operation a breakpoint? 
public boolean isBreakpoint = false; 

Are calls disabled? 
public boolean callsDisabled = false; 

/* X coordinate of operation center */ 
public double xO; 

/* y coordinate of operation center */ 
public double yO; 
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APPENDIX D 



package j unglee . vdbms . wdk . operations ; 

import j unglee . vdbms . wdk . visual . * ; 

import j unglee . vdbms . wdk . visualgui . * ; 

import j unglee . vdbms . wdk . interpreter . * ; 

import j unglee . vdbms . wdk . interpreter . Environment ; 

import j unglee . vdbms . wdk . util . 

import java.util. 

import java.net.*; 

* Match Operation 

public class MatchOperation extends Operation { 

* Constructor 
*/ 

public MatchOperation { ) {} 

* Iterate over text using the match expression entered 

* in the Match property. 

* Additional options are: 

* - Read initial text from URL (URL property) 

* - Follow URLs after match (FollowLinks property) 

. public final . Environment call (Environment state) 
throws Throwable 

{ 

// Create new copy of state 

Environment newState = new Environment () ; 

state . transfer (newState) ; 

V 

// Temporarily make mutable ' to - debug memory usage- SFE change 
Environment ■ newState = state; 

Interpreter interpreter = new Interpreter (newState ) ; 

// Fetch url, input text, start position, end position 
■ String parentUrl = state . evaluateVariable (Environment . URL) ; 
String input = state . evaluateVariable (Environment . TEXT) ; 
String startStr = state . evaluateVariable (Environment .START ) ; 
String endStr = state . evaluateVariable (Environment . END) ; 
int startint = -1; 
int endint = -1; 

// Obtain start position 
if (StartStr !=null) { 

Integer startlnteger = new Integer ( startStr ) ; 

Startint = startlnteger . intValue () ; 

} 

// Obtain end position 
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if (endStr!=null) { 

Integer endlnteger = new Integer (endStr) ; 
endint = endlnteger . intValue {) ; 

} 

input = input . substring (start Int, endint); 

// If start url specified 
if ( !startUrl. equals {"") ) { 

input = f ollowLink (startUri, null); 

} 

// Initialize input & match expression 

newState . setVariable (Environment . TEXT, input, false) ; 

Vector vars = interpreter . getVariables (match) ; 

// Iteratively match 
for {;;) { 

Vector expressions = interpreter .parseExpressionSequence (match) ; 
interpreter . evaluateExpressionSequence (expressions ) ; 
if ( ! interpreter . hasMorelnput ( ) ) break; 

// Call link for each variable 
Enumeration e = vars . elements () ; 
for ( ; e . hasMoreElements ( ) ; ) { 

String variable = ( String) e . nextElement () ; 

String value - newState . evaluateVariable (variable) ; 

// If followLinks true, follow URLs 
if (followLinks .booleanValue 0 ) {• 

TextParser parser = new TextParser (value ) ; 
// Iterate through each url 
for (; parser . hasMoreUrls 0; ) { 

String url = parser . nextUrl (parentUrl) ; 

if (url==null) continue; 

// Eliminate duplicates 

if (theTable.get (url)==null) { 

theTable.put (url, "") ; 
} else { 
continue; 

} 

String newPage = f ollowLink (url, null); 

newState . setVariable (Environment . TEXT, newPage, false); 
newState . setVariable (Environment . URL, url, false); 
newState . setVariable (Environment . START, ""+0, false) ; 
newState. setVariable (Environment . END, ""+newPage . length ( ) , 

false) ; 

/* Environment tmpState = */ newState = call (this, 
getOperation (variable) , newState) ; 

/* tmpState .transfer (state) ; SEE change */ 

} 

} else { 

// If followLinks false, do not follow URLs 
int start = 0; 
int end =0; 
try { 

start = interpreter . getMatchStart (variable) ; 
end = interpreter. getMatchEnd(variable) ; 
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} catch (Exception ex) { 
// No selection on failure 

} 

newState. setVariable (Environment . TEXT, input, false) ; 
newState.setVariable (Environment .START, ""+start, false) ; 
newState . setVariable (Environment . END, ""+end, false) ; 
/* Environment tmpState = */ newState = call (this, 
getOperation (variable) , newState) ; 

/* tmpState .transfer (state) ; SEE change */ 

} 

} 

} 

// Emit rows if necessary 
if ( lemitRows. equals ("") ) { 

interpreter . evaluateExpression ( "emit-rows ( ' "+emitRows+" ' ) "/ 0) ; 

} 

return state; 



Return set of link names .used ' by ; this operation 
public String [] getLinkNames ( ) 
{ 

Environment env = new Environment ( ) ; 
Interpreter interpreter = new Interpreter (env) ; 
Vector linkVector = interpreter .getVariables (match) ; 
String[] linkArray = new String [linkVector . size ()] ; 
linkVector . copylnto ( ( String [ ] ) linkArray) ; 
return linkArray; 

} 

//////////////// Methods to define Properties //////////////// 
String match = ""; 

public String getMatchO { return match; } 

public void setMatch (String match) { this. match = match; } 
String startUrl = ""; 

public String getStartUrl () { return startUrl; } 

public void setStartUrl ( String url) {. this . startUrl = url; } 

Boolean followLinks = new Boolean (false) ; 
public Boolean getFollowLinks ( ) { return followLinks; } 
public .void setFollowLinks ( Boolean .followLinks) { this . followLinks = 
followLinks; } 

String emitRows = new String (""); 

public String getEmitRows () { return emitRows; } 

public void setEmitRows ( String emitRows) { this . emitRows = emitRows; 



// Eliminate duplicates 

public static Hashtable theTable; 

} 
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APPENDIX E 



package junglee . vdbms . wdk. visual; 
import j ava . awt . * ; 
import java.io.*; 

* <b> Link Class </b> 

■A- 

* <p>This class is used to represent links in a wrapper model. 

* A link is identified as a directed line connecting two operations. 

* A link is associated with: <br> 

* <ul> 

* <li> A start operation </li> 

* <li> An end operation </li> 

* </ul> 

* <p>Copyright (c) 1997, Junglee Corp. 

* etitle Link 

* @author Stephan Erickson 

* (aversion 1.0 

public class Link 

extends WrapperElement 
implements Serializable 

{ 

//^'k'k-k'k-k'k-k-k-k-k-k-k-k-k-k-k-k-k MODEL OPERATIONS ^^^^^^^^-^^-'f********* 

public Link() 
{ 

super ( ) ; 

} 

* Constructor. 

* Provide start and end operations. Default constructor 

* returns a directed link with arrow pointing to end operation. 

* Does nothing . if .either operation is null 

* @param start the start, operation 

* @param end the end operation 
^/ 

public Link (Operation start. Operation end) 
{ 

theStartOperation = start; 
theStartOperationId = start . get Id () ; 
theEndOperation = end; 
theEndOperationId = end.getld(); 

} 

* Return start operation of link 

* ©return Start Operation 
V 

public Operation getStartOperation { ) 
{ 

return theStartOperation; 
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/ * ★ 

* Set start operation of link 

* @param Start Operation 

public void setStartOperation (Operation start) 
{ 

theStartOperation = start; 
theStartOperationld = start . getid () ; 

} 

/ -A- ★ 

* Set end operation of link 

* @parain end Operation 

public void setEndOperation (Operation end) 
{ 

theEndOperation = end; 
theEndOperationId = end.getldO; 

} 

* Return end operation of link 
@return End Operation 

public Operation getEndOperation () 
{ 

return theEndOperation; 

} 

* Set start operation id of link 
V 

public void setStartOperationId (int id) 
{ 

theStartOperationld = id; 

} 



I -k -k 

* Return start operation id of link 

* @return Start Operation Id 
V 

public int getStartOperationId ( ) 
{ 

return theStartOperationld; 

} 

/ ★ ★ 

* Set end operation id of link 
public void setEndOperationId ( int id) 
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theEndOperationId = id; 

} 

I -k-k 

* Return end operation id of link 

* ©return End Operation Id 

public int getEndOperationId ( ) 
{ 

return theEndOperationId; 

} 

+ * GRAPHICS OPERATIONS + * 

* Distance from link 

* @param x the x coordinate 

* @param y the y coordinate 

* ©return distance from link 

public double distanceFrom (double x, double y) 
{ 

double length = 

Math, sqrt ( { theEndOperation . xO-theStartOperation . xO ) 
{ theEndOperation . xO-theStartOperation . xO ) + 
(theEndOperation. yO-theStartOperation. yO) * 
( theEndOperation . yO-theStartOperation . yO ) ) ; 
double cos = ( theEndOperation . xO-theStartOperation . xO ) /length; 
double sin = (theEndOperation. yO-theStartOperation. yO) /length; 
double distance = Math . abs ( ( theStartOperation . xO-x) *sin+ 
(y-theStartOperation. yO) *cos) ; 

return distance; 



I I -k k -k -k k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k PRIVATE VARIABLES -k-k-k-kk:k-k-kk:-k-k'k-k-k^'k'k'kk:k:'k 

/* The start operation */ 

private Operation theStartOperation; 

1-^ The end operation */ 

private Operation theEndOperation; 

/•^ The start operation id */ 
private int theStartOperationId; 

/* The end operation id */ 
private int theEndOperationId; 
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